Release 10.1A: OpenEdge Deployment:
Managing 4GL Applications

Specifying keyboard mappings

The PROTERMCAP file maps key functions to key labels. Table 4–12 shows the mappings as installed. Many of the mappings shown are terminal specific, and certain terminals might not support the function for a particular sequence given in the table.

Table 4–12: OpenEdge PROTERMCAP key functions

Key function	UNIX key label
ABORT	CTRL-\ CTRL-ALT-DEL
APPEND-LINE	CTRL-A
BACKSPACE	BACKSPACE CTRL-H DEL-CHAR
BACK-TAB	BACK-TAB CTRL-U SHIFT-TAB
BELL	BELL CTRL-G
BLOCK	SELECT CTRL-V
BOTTOM-COLUMN	ESC-CTRL-B
BREAK-LINE	ESC-B
CANCEL-PICK	ESC-CTRL-X
CHOICES	ESC-CTRL-H
CLEAR	F8 CTRL-Z
CLOSE	ESC-Z
COMPILE	ESC-P
COPY	F11 ESC-C
CURSOR-DOWN	CURSOR-DOWN CTRL-J
CURSOR-LEFT	CURSOR-LEFT CTRL-O
CURSOR-RIGHT	CURSOR-RIGHT CTRL-L
CURSOR-UP	CURSOR-UP CTRL-K
CUT	F10 ESC-X
DEFAULT-POP-UP	ESC-U
DELETE-CHARACTER	DEL
DELETE-COLUMN	ESC-CTRL-Z
DELETE-END-LINE	ESC-K
DELETE-FIELD	ESC-CTRL-D
DELETE-LINE	REMOVE CTRL-D
DELETE-WORD	ESC-D
EDITOR-BACKTAB	CTRL-B
EDITOR-TAB	CTRL-G
END	END ESC -> ESC-.
END-ERROR	F4 PF4 ESC CTRL-E
ENTER-MENUBAR	F3 PF3 ESC-M
EXIT	ESC-Q
FIND	CTRL-F FIND
FIND-NEXT	ESC-F
FIND-PREVIOUS	ESC-I
GET	F5 ESC-O
GO	F1 PF1 CTRL-X DO
GOTO	ESC-G
HELP	HELP F2 ESC-? PF2
HOME	HOME ESC-H ESC-h ESC-< ESC-,
INSERT-COLUMN	ESC-CTRL-N
INSERT-FIELD	ESC-CTRL-G
INSERT-FIELD-DATA	ESC-CTRL-F
INSERT-FIELD-LABEL	ESC-CTRL-E
INSERT-MODE	INS F9 CTRL-T CTRL-@
LEFT-END	ESC-LEFT-ARROW ALT-LEFT-ARROW
MAIN-MENU	ESC-CTRL-M
MOVE	ESC-CTRL-V
NEW	ESC-N
NEW-LINE	INSERT-HERE CTRL-N
NEXT-ERROR	ESC-E
NEXT-FRAME	ESC-CTRL-I
NEXT-WORD	CTRL-W
OPEN-LINE-ABOVE	ESC-L
OPTIONS	ESC-CTRL-O
PAGE-DOWN	PAGE-DOWN ESC-CURSOR-DOWN ESC-DOWN-ARROW NEXT-PAGE NEXT-SCRN
PAGE-LEFT	ESC-W
PAGE-RIGHT	ESC-Y ESC-CTRL-J
PAGE-RIGHT-TEXT	ESC-CTRL-J
PAGE-UP	PAGE-UP ESC-CURSOR-UP ESC-UP-ARROW PREV-PAGE PREV-SCRN
PASTE	F12 ESC-V
PICK	ESC-CTRL-P
PICK-AREA	ESC-CTRL-W
PICK-BOTH	ESC-CTRL-Q
PREV-FRAME	ESC-CTRL-U
PREV-WORD	CTRL-P
PUT	F6 ESC-S
RECALL	F7 CTRL-R
REPLACE	ESC-R
REPORTS	ESC-CTRL-A
RESUME-DISPLAY	CTRL-Q
RETURN	RETURN CTRL-M
RIGHT-END	ESC-CURSOR-RIGHT ESC-RIGHT-ARROW ALT-RIGHT-ARROW
SAVE-AS	ESC-A
SCROLL-LEFT	ESC-CTRL-L
SCROLL-MODE	ESC-T
SCROLL-RIGHT	ESC-CTRL-R
SETTINGS	ESC-CTRL-@
STOP	CTRL-C CTRL-BREAK
STOP-DISPLAY	CTRL-S
TAB	TAB CTRL-I
TOP-COLUMN	ESC-CTRL-T

Using key function syntax

To change any of these mappings or create new ones, use the following syntax:

keyfunction(key-label) = sequence:

keyfunction

The name of a key function.

key-label

The key label as it appears on the keyboard.

sequence

The characters transmitted when the key is pressed.

As in other sections of the PROTERMCAP file, string values are assigned using an equal sign (=) and the field is terminated with a colon (:).

For example:

RECALL(F7)=^AF\r:

This field in a PROTERMCAP terminal entry defines the F7 key as transmitting a CTRL+A followed by a capital F followed by a carriage return, and associates use of F7 with the RECALL function.

The following field defines SCROLL-DOWN to act like PAGE-DOWN:

PAGE-DOWN(SCROLL-DOWN)=\021:

If you assign the same key label to two or more different key functions, you get a warning message when you start OpenEdge. For example, “You cannot use DELETE for both DELETE-CHARACTER and BACKSPACE.”

If you use a key in the Progress ON statement or GO-ON option only, and do not have to assign it to a standard action, then use the following syntax in the PROTERMCAP entry:

(key-label)=sequence:

For example, the following entry indicates that pressing F16 sends a capital O followed by a carriage return:

(F16)=O\r:

If any of the control code sequences sent when you press a key on the keyboard begin with a control key, you cannot use that control key on your keyboard and the key does not have its normal OpenEdge meaning. For example, if you specify CTRL+F in a control code sequence when creating a key mapping, you can no longer use CTRL+F for FIND. You have to map another key to the FIND action.

The key labels that the UNIX stty command specifies for FLUSH and SUSPEND override the PROTERMCAP file’s use of the same key labels. For example, if the stty settings for FLUSH and SUSPEND are CTRL+Q and CTRL+S, you cannot map these key labels to key functions in the PROTERMCAP file. If you do, you receive no warning; the labels assume their stty meanings at run time and OpenEdge ignores them.

UNIX stty control functions

The installed PROTERMCAP file does not map the Progress functions ABORT, STOP, and UNIX-END to key labels. OpenEdge instead uses the key labels that the UNIX stty command specifies for QUIT, INTR and EOF respectively.

For example, the following stty command specifies that OpenEdge should use CTRL+\ for ABORT, CTRL+C for STOP, and CTRL+D for UNIX-END:

stty quit ^\ intr ^C eof ^D

The labels specified by the stty command are of two forms: either CTRL+X or DEL if the DELETE key (octal 177, decimal 127) is used. When entering the stty command, indicate the control character by holding down the CTRL key and pressing the specified key; you do not type a caret (^) followed by the key.

If an entry in the PROTERMCAP file uses one of the key labels specified in the stty command, you get a warning message when you start OpenEdge. For example, if the stty command specifies the DELETE key for the STOP function and the PROTERMCAP file specifies the DELETE key for the DELETE-CHARACTER function, you receive a warning message.

In UNIX environments that do not use the Bourne shell (for example, the Korn shell or C shell), job control allows you to end a job currently executing on a terminal. In most environments this is initiated using CTRL+Z; however, OpenEdge uses this character sequence to clear the editor.